جلب بيانات المجموعة

استرداد معلومات مفصلة حول مجموعة محددة.

GET

https://api.wawp.net/v2/groups/{id}?access_token=123456789&id=1234567890%40g.us&instance_id=123456789

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/groups/{id}

يدعم

GET

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

البيانات الوصفية

يعيد هذا المعلومات الأساسية (الموضوع، المالك، وقت الإنشاء).

لا يوجد مشاركون

لا تعيد نقطة النهاية هذه قائمة المشاركين الكاملة. استخدم '/groups/{id}/participants' لذلك.

توصيات

قم بتخزين هذه البيانات الوصفية مؤقتًا؛ فهي نادراً ما تتغير.
استخدم هذا للتحقق مما إذا كان معرّف مجموعة JID لا يزال صالحًا/يمكن الوصول إليه.
تحقق من خاصية 'announce' لمعرفة ما إذا كان المسؤولون فقط هم من يمكنهم إرسال الرسائل.

الاكتشاف في الوقت الفعلي: إتقان حالة مجتمعاتك

تعد واجهة جلب بيانات المجموعة أكثر من مجرد أداة لاسترداد البيانات؛ إنها آليتك الأساسية لـ اكتشاف الحالة والتحقق منها في الوقت الفعلي. في بيئة يمكن فيها لعشرات المشاركين وبوتات الأتمتة التفاعل مع مجموعة واحدة، قد تختلف سجلاتك الداخلية عن الواقع الفعلي لشبكة واتساب. تعمل هذه الواجهة كـ "مصدر للحقيقة" (Source of Truth).

🏗️ الفلسفة المعمارية: حلقة التحقق

من منظور هندسة النظام، جلب معلومات المجموعة هو فعل تهيئة. قبل أن يحاول نظامك إجراء عملية حساسة — مثل إضافة مشارك أو ترقية مسؤول — يجب عليه أولاً التحقق من التكوين الحالي للمجموعة.

الفوائد المعمارية الرئيسية:

تدقيق الصلاحيات: يمكنك التحقق مما إذا كان مثيل Wawp لا يزال يمتلك صلاحيات المسؤول (Admin). بما أنه يمكن سحب هذه الصلاحيات يدوياً من قبل إنسان، فإن التحقق المسبق يمنع فشل العمليات المؤتمتة.
مزامنة البيانات الوصفية: يمكن للمستخدمين تغيير اسم المجموعة أو صورتها في أي وقت. تتيح لك هذه الواجهة إعادة مزامنة لوحة التحكم الخاصة بك مع آخر هوية بصرية للمجموعة.
فحص الصحة الهيكلية: تتيح لك هذه الواجهة التحقق مما إذا كانت المجموعة لا تزال "نشطة". إذا تم حذف المجموعة أو طرد مثيلك، فستتلقى خطأ 404 أو 403، مما يضمن أن نظام الأتمتة لا يحاول معالجة تفاعلات لمجتمعات "شبحية".

🛡️ استراتيجية التخزين المؤقت (Caching)

نوصي باستراتيجية "التحديث التفاعلي":

جلب البيانات عند تحديد المجموعة أو إنشائها لأول مرة.
الاستماع لويب هوك group.update بدلاً من الاستعلام المستمر.
استخدام البيانات المخزنة مؤقتاً للعرض غير الحرج، واستخدام الواجهة الحية (Live API) للعمليات عالية الخطورة مثل إدارة المشاركين.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

بارامترات الرابط

جزء من مسار الرابط أو استعلام

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		المعرف الفريد للمجموعة (@g.us) مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/groups/1234567890@g.us";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10  method: "GET",
11  headers: { "Content-Type": "application/json" },
12  
13})
14  .then(async (response) => {
15    if (response.ok) {
16      const data = await response.json();
17      console.log("Success:", data);
18      return data;
19    }
20    
21    // Error Handling
22    
23
24    const errorText = await response.text();
25    console.error(`Error ${response.status}: ${errorText}`);
26  })
27  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 27, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Group info retrieved

application/json

string *

Example

{
"id": "1234567890@g.us",
"name": "Project Alpha",
"description": "Main coordination group"
}

الموضوع السابقجلب عدد المجموعات

الموضوع التاليمغادرة المجموعة